<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../../style.css" type="text/css" media="screen">
<link rel="stylesheet" href="../../print.css" type="text/css" media="print">
<meta content="StringUtils,flexcommon.utils.StringUtils,abbreviate,capitalize,compare,contains,count,defaultString,isAlpha,isAlphaNumeric,isEmpty,isNotEmpty,isNumeric,left,leftPad,lowercase,replaceAll,replaceFirst,right,startsWith,substringAfter,substringAfterLast,substringBefore,tokenize,trim,uppercase" name="keywords">
<title>flexcommon.utils.StringUtils</title>
</head>
<body>
<script type="text/javascript" language="javascript" src="../../asdoc.js"></script><script type="text/javascript" language="javascript" src="../../cookies.js"></script><script type="text/javascript" language="javascript">
<!--
				asdocTitle = 'StringUtils - Flexcommon 1.3';
				var baseRef = '../../';
				window.onload = configPage;
			--></script>
<table style="display:none" id="titleTable" cellspacing="0" cellpadding="0" class="titleTable">
<tr>
<td align="left" class="titleTableTitle">Flexcommon 1.3</td><td align="right" class="titleTableTopNav"><a onclick="loadClassListFrame('../../all-classes.html')" href="../../package-summary.html">All&nbsp;Packages</a>&nbsp;|&nbsp;<a onclick="loadClassListFrame('../../all-classes.html')" href="../../class-summary.html">All&nbsp;Classes</a>&nbsp;|&nbsp;<a onclick="loadClassListFrame('../../index-list.html')" href="../../all-index-A.html">Index</a>&nbsp;|&nbsp;<a href="../../index.html?flexcommon/utils/StringUtils.html&amp;flexcommon/utils/class-list.html" id="framesLink1">Frames</a><a onclick="parent.location=document.location" href="" style="display:none" id="noFramesLink1">No&nbsp;Frames</a></td><td rowspan="3" align="right" class="titleTableLogo"><img alt="Adobe Logo" title="Adobe Logo" class="logoImage" src="../../images/logo.jpg"></td>
</tr>
<tr class="titleTableRow2">
<td align="left" id="subTitle" class="titleTableSubTitle">Class&nbsp;StringUtils</td><td align="right" id="subNav" class="titleTableSubNav"><a href="#methodSummary">Methods</a></td>
</tr>
<tr class="titleTableRow3">
<td colspan="2">&nbsp;</td>
</tr>
</table>
<script type="text/javascript" language="javascript">
<!--
if (!isEclipse() || window.name != ECLIPSE_FRAME_NAME) {titleBar_setSubTitle("Class StringUtils"); titleBar_setSubNav(false,false,false,false,false,false,true,false,false,false,false,false,false,false);}
--></script>
<div class="MainContent">
<table cellspacing="0" cellpadding="0" class="classHeaderTable">
<tr>
<td class="classHeaderTableLabel">Package</td><td><a onclick="javascript:loadClassListFrame('class-list.html')" href="package-detail.html">flexcommon.utils</a></td>
</tr>
<tr>
<td class="classHeaderTableLabel">Class</td><td class="classSignature">public class StringUtils</td>
</tr>
</table>
<p></p>
  Class containing some static string utility methods.
    <p>Author: Dimitrios Gianninas</p>
  <p></p>
<br>
<hr>
</div>
<a name="methodSummary"></a>
<div class="summarySection">
<div class="summaryTableTitle">Public Methods</div>
<table id="summaryTableMethod" class="summaryTable " cellpadding="3" cellspacing="0">
<tr>
<th>&nbsp;</th><th colspan="2">Method</th><th class="summaryTableOwnerCol">Defined&nbsp;by</th>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#abbreviate()">abbreviate</a>(str:String, maxLength:Number):String</div>
<div class="summaryTableDescription">[static]
   Abbreviates a String using ellipses.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#capitalize()">capitalize</a>(str:String):String</div>
<div class="summaryTableDescription">[static]
     Capitalizes the string, changing the first character to uppercase.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#compare()">compare</a>(s1:String, s2:String):Number</div>
<div class="summaryTableDescription">[static]
   Compares two strings (case-insensitive) and returns an integer
   representing their natural alphabetical order.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#contains()">contains</a>(s1:String, s2:String):Boolean</div>
<div class="summaryTableDescription">[static]
   Determines if a string value is contained within the given string.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#count()">count</a>(s1:String, s2:String):Number</div>
<div class="summaryTableDescription">[static]
   Counts the number of occurance of string s2 in s1.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#defaultString()">defaultString</a>(str:String):String</div>
<div class="summaryTableDescription">[static]
   Returns either the passed in String, or if the String is empty or null, an empty String ("").</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#isAlpha()">isAlpha</a>(str:String):Boolean</div>
<div class="summaryTableDescription">[static]
     Determines if a string contains only alphabetic characters.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#isAlphaNumeric()">isAlphaNumeric</a>(str:String):Boolean</div>
<div class="summaryTableDescription">[static]
     Determines if a string contains only alphabetic characters.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#isEmpty()">isEmpty</a>(str:String):Boolean</div>
<div class="summaryTableDescription">[static]
   Determines if a string value is empty.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#isNotEmpty()">isNotEmpty</a>(str:String):Boolean</div>
<div class="summaryTableDescription">[static]
   Determines if a string value is not empty.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#isNumeric()">isNumeric</a>(str:String):Boolean</div>
<div class="summaryTableDescription">[static]
     Determines if a string contains only numeric characters (0-9).</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#left()">left</a>(str:String, length:int):String</div>
<div class="summaryTableDescription">[static]
     Returns the lefmost length characters of a string.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#leftPad()">leftPad</a>(str:String, length:int, char:String = "0"):String</div>
<div class="summaryTableDescription">[static]
   Pads a string with a specified character up to a specified length.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#lowercase()">lowercase</a>(str:String):String</div>
<div class="summaryTableDescription">[static]
     Converts a string to lowercase.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#replaceAll()">replaceAll</a>(str:String, oldToken:String, newToken:String):String</div>
<div class="summaryTableDescription">[static]
   Replaces all occurances of a token within a string with another token.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#replaceFirst()">replaceFirst</a>(str:String, oldToken:String, newToken:String):String</div>
<div class="summaryTableDescription">[static]
   Replaces the first occurence of a token within a string with another token.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#right()">right</a>(str:String, length:int):String</div>
<div class="summaryTableDescription">[static]
     Returns the rightmost length characters of a string.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#startsWith()">startsWith</a>(s1:String, s2:String):Boolean</div>
<div class="summaryTableDescription">[static]
   Determines if a string s1 starts with the string s2.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#substringAfter()">substringAfter</a>(str:String, sep:String):String</div>
<div class="summaryTableDescription">[static]
   Gets the substring after the first occurance of a separator.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#substringAfterLast()">substringAfterLast</a>(str:String, sep:String):String</div>
<div class="summaryTableDescription">[static]
   Gets the substring after the last occurance of a separator.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#substringBefore()">substringBefore</a>(str:String, sep:String):String</div>
<div class="summaryTableDescription">[static]
   Gets the substring before the first occurance of a separator.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#tokenize()">tokenize</a>(str:String, delim:String):Array</div>
<div class="summaryTableDescription">[static]
   Cuts up a string into its various tokens based on the delimiter specified.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#trim()">trim</a>(str:String):String</div>
<div class="summaryTableDescription">[static]
   Removes starting and trailing spaces from a string.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
<tr class="">
<td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol">
<div class="summarySignature">
<a class="signatureLink" href="#uppercase()">uppercase</a>(str:String):String</div>
<div class="summaryTableDescription">[static]
     Converts a string to uppercase.</div>
</td><td class="summaryTableOwnerCol">StringUtils</td>
</tr>
</table>
</div>
<script type="text/javascript" language="javascript">
<!--
showHideInherited();
--></script>
<div class="MainContent">
<a name="methodDetail"></a>
<div class="detailSectionHeader">Method detail</div>
<a name="abbreviate()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">abbreviate</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td>
</tr>
</table>
<div class="detailBody">
<code>public static function abbreviate(str:String, maxLength:Number):String</code><p>
   Abbreviates a String using ellipses.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.abbreviate( null, ) = null</li>
   <li>StringUtils.abbreviate( "", ) = ""</li>
   <li>StringUtils.abbreviate( "abcdefg", 7 ) = "abcd..."</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to abbreviate
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">maxLength</span>:Number</code> &mdash; maximum length of result string
   
   </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the abbreviate string
   </td>
</tr>
</table>
</div>
<a name="capitalize()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">capitalize</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function capitalize(str:String):String</code><p>
     Capitalizes the string, changing the first character to uppercase.
     
     </p><p>Examples:</p>
     
     <ul>
     <li>StringUtils.capitalize( null ) = null</li>
     <li>StringUtils.capitalize( "" ) = ""</li>
     <li>StringUtils.capitalize( "hello" ) = "Hello"</li>
     </ul>
     
     <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to capitalize
     
     </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the capitalized string
     </td>
</tr>
</table>
</div>
<a name="compare()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">compare</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function compare(s1:String, s2:String):Number</code><p>
   Compares two strings (case-insensitive) and returns an integer
   representing their natural alphabetical order.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.compare( "Hello World", "Hello World" ) = 0</li>
   <li>StringUtils.compare( "Hello World", "A new world" ) = 1</li>
   <li>StringUtils.compare( "Hello World", "90210" ) = 1</li>
   <li>StringUtils.compare( "Hello World", "Zulu time" ) = -1</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">s1</span>:String</code> &mdash; the string being compared 
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">s2</span>:String</code> &mdash; the string to compare against
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Number</code> &mdash; 0 if equal, 1 is s1 is after s2, -1 if s1 is before s2
   </td>
</tr>
</table>
</div>
<a name="contains()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">contains</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function contains(s1:String, s2:String):Boolean</code><p>
   Determines if a string value is contained within the given string.
   
   </p><span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">s1</span>:String</code> &mdash; the string being evaluated 
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">s2</span>:String</code> &mdash; the string to locate within s1
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Boolean</code> &mdash; TRUE if s2 is found within s1, FALSE otherwise
   </td>
</tr>
</table>
</div>
<a name="count()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">count</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function count(s1:String, s2:String):Number</code><p>
   Counts the number of occurance of string s2 in s1.
   
   </p><span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">s1</span>:String</code> &mdash; the string being evaluated 
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">s2</span>:String</code> &mdash; the string to locate within s1
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Number</code> &mdash; the number of occurances of s2 in s1, 0 otherwise
   </td>
</tr>
</table>
</div>
<a name="defaultString()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">defaultString</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function defaultString(str:String):String</code><p>
   Returns either the passed in String, or if the String is empty or null, an empty String ("").
   
   </p><span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string being evaluated 
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the string itself, or an empty string if null.
   </td>
</tr>
</table>
</div>
<a name="isAlpha()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">isAlpha</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function isAlpha(str:String):Boolean</code><p>
     Determines if a string contains only alphabetic characters.
     
     </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.isAlpha( "Hello World" ) = false</li>
   <li>StringUtils.isAlpha( "123" ) = false</li>
   <li>StringUtils.isAlpha( "Hello" ) = true</li>
   <li>StringUtils.isAlpha( null ) = false</li>
     <li>StringUtils.isAlpha( "" ) = false</li>
   </ul>
     
     <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string being evaluated 
          </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Boolean</code> &mdash; TRUE if the string contains only alphabetic characters, FALSE otherwise
     </td>
</tr>
</table>
</div>
<a name="isAlphaNumeric()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">isAlphaNumeric</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function isAlphaNumeric(str:String):Boolean</code><p>
     Determines if a string contains only alphabetic characters.
     
     </p><p>Examples:</p>
     
     <ul>
     <li>StringUtils.isAlphaNumeric( "Hello World" ) = false</li>
     <li>StringUtils.isAlphaNumeric( "123" ) = true</li>
     <li>StringUtils.isAlphaNumeric( "Hello" ) = true</li>
     <li>StringUtils.isAlphaNumeric( "Hello123" ) = true</li>
     <li>StringUtils.isAlphaNumeric( null ) = false</li>
     <li>StringUtils.isAlphaNumeric( "" ) = false</li>
     </ul>
     
     <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string being evaluated 
          </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Boolean</code> &mdash; TRUE if the string contains only alphabetic characters, FALSE otherwise
     </td>
</tr>
</table>
</div>
<a name="isEmpty()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">isEmpty</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function isEmpty(str:String):Boolean</code><p>
   Determines if a string value is empty. Either null or equal to "".
   
   </p><span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string being evaluated 
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Boolean</code> &mdash; TRUE if the string is empty or null, FALSE otherwise
   </td>
</tr>
</table>
</div>
<a name="isNotEmpty()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">isNotEmpty</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function isNotEmpty(str:String):Boolean</code><p>
   Determines if a string value is not empty.
   
   </p><span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string being evaluated 
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Boolean</code> &mdash; TRUE if the string is not empty or null, FALSE otherwise
   </td>
</tr>
</table>
</div>
<a name="isNumeric()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">isNumeric</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function isNumeric(str:String):Boolean</code><p>
     Determines if a string contains only numeric characters (0-9).
     
     </p><span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string being evaluated
     
     </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Boolean</code> &mdash; TRUE if the string contains only numeric characters, FALSE otherwise
     </td>
</tr>
</table>
</div>
<a name="left()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">left</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function left(str:String, length:int):String</code><p>
     Returns the lefmost length characters of a string.
     
     </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.left( null, 5 ) = null</li>
   <li>StringUtils.left( "Hello World", 5 ) = "Hello"</li>
   <li>StringUtils.left( "Hello World", 99 ) = ""</li>
   </ul>
     
     <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
     </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">length</span>:int</code> &mdash; the length of characters to return
     </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the leftmost characters
     </td>
</tr>
</table>
</div>
<a name="leftPad()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">leftPad</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function leftPad(str:String, length:int, char:String = "0"):String</code><p>
   Pads a string with a specified character up to a specified length.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.leftPad( "Hello World", -1 ) = "Hello World"</li>
   <li>StringUtils.leftPad( "Hello World", 5 ) = "00000Hello World"</li>
   <li>StringUtils.leftPad( "Hello World", 5, "z" ) = "zzzzzHello World"</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to pad
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">length</span>:int</code> &mdash; the amount of padded to apply
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">char</span>:String</code> (default = "<code>0</code>")<code></code> &mdash; the character to pad, if none specified, pads with "0" 
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the padded string
   </td>
</tr>
</table>
</div>
<a name="lowercase()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">lowercase</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function lowercase(str:String):String</code><p>
     Converts a string to lowercase.
     
     </p><p>Examples:</p>
     
     <ul>
     <li>StringUtils.lowercase( null ) = null</li>
     <li>StringUtils.lowercase( "" ) = ""</li>
     <li>StringUtils.lowercase( "Hello World" ) = "hello world"</li>
     </ul>
     
     <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
     </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the string in lowercase
     </td>
</tr>
</table>
</div>
<a name="replaceAll()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">replaceAll</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function replaceAll(str:String, oldToken:String, newToken:String):String</code><p>
   Replaces all occurances of a token within a string with another token.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.replaceAll( "Hello World", "World", "Ladies" ) = "Hello Ladies"</li>
   <li>StringUtils.replaceAll( "Hello World", "", "" ) = "Hello World"</li>
   <li>StringUtils.replaceAll( "Hello World", "Dude", "Ladies" ) = "Hello World"</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">oldToken</span>:String</code> &mdash; the token with str to be replaced
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">newToken</span>:String</code> &mdash; the token that will replace all occurances of oldToken within the string 
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the new string
   </td>
</tr>
</table>
</div>
<a name="replaceFirst()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">replaceFirst</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function replaceFirst(str:String, oldToken:String, newToken:String):String</code><p>
   Replaces the first occurence of a token within a string with another token.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.replaceFirst( "Hello World World", "World", "Ladies" ) = "Hello Ladies World"</li>
   <li>StringUtils.replaceFirst( "Hello World", "", "" ) = "Hello World"</li>
   <li>StringUtils.replaceFirst( "Hello World", "Dude", "Ladies" ) = "Hello World"</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">oldToken</span>:String</code> &mdash; the token with str to be replaced
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">newToken</span>:String</code> &mdash; the token that will replace the first occurances of oldToken within the string 
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the new string
   </td>
</tr>
</table>
</div>
<a name="right()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">right</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function right(str:String, length:int):String</code><p>
     Returns the rightmost length characters of a string.
     
     </p><p>Examples:</p>
     
     <ul>
     <li>StringUtils.right( null, 5 ) = null</li>
     <li>StringUtils.right(  -5 ) = ""</li>
     <li>StringUtils.right( "Hello World", 5 ) = "World"</li>
     <li>StringUtils.right( "Hello World", 99 ) = "Hello World"</li>
     </ul>
     
     <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
     </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">length</span>:int</code> &mdash; the length of characters to return
     </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the rightmost characters
     </td>
</tr>
</table>
</div>
<a name="startsWith()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">startsWith</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function startsWith(s1:String, s2:String):Boolean</code><p>
   Determines if a string s1 starts with the string s2.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.startsWith( "Hello World World", "Hello" ) = true</li>
   <li>StringUtils.startsWith( "Hello World", "" ) = false</li>
   <li>StringUtils.startsWith( "Hello World", "Dude" ) = false</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">s1</span>:String</code> &mdash; the string to evaluate
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">s2</span>:String</code> &mdash; the token with str to be replaced
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Boolean</code> &mdash; TRUE if s2 was found at the beginning of s1, FALSE otherwise
   </td>
</tr>
</table>
</div>
<a name="substringAfter()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">substringAfter</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function substringAfter(str:String, sep:String):String</code><p>
   Gets the substring after the first occurance of a separator.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.substringAfter( "The Force is with you young Skywalker", "you" ) = " young Skywalker"</li>
   <li>StringUtils.substringAfter( "The Force is with you young Skywalker", "blue" ) = "The Force is with you young Skywalker"</li>
   <li>StringUtils.substringAfter( "The Force is with you young Skywalker", "" ) = "The Force is with you young Skywalker"</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">sep</span>:String</code> &mdash; the seperator to locate within the string
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the string after the seperator
   </td>
</tr>
</table>
</div>
<a name="substringAfterLast()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">substringAfterLast</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function substringAfterLast(str:String, sep:String):String</code><p>
   Gets the substring after the last occurance of a separator.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.substringAfter( "the Force is the rebell alliance", "the" ) = " rebell alliance"</li>
   <li>StringUtils.substringAfter( "the Force is the rebell alliance", "blue" ) = "the Force is the rebell alliance"</li>
   <li>StringUtils.substringAfter( "the Force is the rebell alliance", "" ) = "the Force is the rebell alliance"</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">sep</span>:String</code> &mdash; the seperator to locate within the string
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the string after the last occurance of the seperator
   </td>
</tr>
</table>
</div>
<a name="substringBefore()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">substringBefore</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function substringBefore(str:String, sep:String):String</code><p>
   Gets the substring before the first occurance of a separator.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.substringBefore( "the Force is the rebell alliance", "is" ) = "the Force "</li>
   <li>StringUtils.substringBefore( "the Force is the rebell alliance", "blue" ) = "the Force is the rebell alliance"</li>
   <li>StringUtils.substringBefore( "the Force is the rebell alliance", "" ) = "the Force is the rebell alliance"</li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">sep</span>:String</code> &mdash; the seperator to locate within the string
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the string before the occurance of the seperator
   </td>
</tr>
</table>
</div>
<a name="tokenize()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">tokenize</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function tokenize(str:String, delim:String):Array</code><p>
   Cuts up a string into its various tokens based on the delimiter specified.
   The tokens are returned as an array of strings.
   
   </p><p>Examples:</p>
   
   <ul>
   <li>StringUtils.tokenize( "the Force is the rebell alliance", " " ) = [the,Force,is,the,rebell,alliance]</li>
   <li>StringUtils.tokenize( "the Force is the rebell alliance", "blue" ) = []</li>
   <li>StringUtils.tokenize( "the Force is the rebell alliance", "" ) = []/li>
   </ul>
   
   <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to tokenize
   </td>
</tr>
<tr>
<td class="paramSpacer">&nbsp;</td>
</tr>
<tr>
<td width="20px"></td><td><code><span class="label">delim</span>:String</code> &mdash; the string to use as a delimiter
      </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>Array</code> &mdash; an Array with all the tokens
   </td>
</tr>
</table>
</div>
<a name="trim()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">trim</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function trim(str:String):String</code><p>
   Removes starting and trailing spaces from a string.
   
   </p><span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to trim
   
   </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the trimmed string
   </td>
</tr>
</table>
</div>
<a name="uppercase()"></a>
<table cellspacing="0" cellpadding="0" class="detailHeader">
<tr>
<td class="detailHeaderName">uppercase</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">method</td><td class="detailHeaderRule">&nbsp;</td>
</tr>
</table>
<div class="detailBody">
<code>public static function uppercase(str:String):String</code><p>
     Converts a string to uppercase.
     
     </p><p>Examples:</p>
     
     <ul>
     <li>StringUtils.uppercase( null ) = null</li>
     <li>StringUtils.uppercase( "" ) = ""</li>
     <li>StringUtils.uppercase( "Hello World" ) = "HELLO WORLD"</li>
     </ul>
     
     <span class="label">Parameters</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20px"></td><td><code><span class="label">str</span>:String</code> &mdash; the string to evaluate
     </td>
</tr>
</table>
<p></p>
<span class="label">Returns</span>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="20"></td><td><code>String</code> &mdash; the string in uppercase
     </td>
</tr>
</table>
</div>
<br>
<br>
<hr>
<br>
<p></p>
<center class="copyright"> 
</center>
</div>
</body>
</html>
<!-- -->
